Optional
Methods in Control Interfaces
Implementing
an interface doesn t necessarily mean implementing all methods of that
interface to do anything more than return E_NOTIMPL or S_OK as appropriate. The
following table identifies the methods of the interfaces listed in the What
Support for an Interface Means
section that a control may implement in this manner. Check with the SDK OLE
Reference documentation for full syntax and valid return values from these
methods. Any method not listed here must be fully implemented if the interface
is supported.
|
Method |
Comments |
|
IOleControl |
|
|
GetControlInfo,
OnMnemonic |
Mandatory
for controls with mnemonics. |
|
OnAmbientPropertyChange |
Mandatory
for controls that use ambient properties. |
|
FreezeEvents |
See Event
Freezing in the
General Guidelines section. |
|
|
|
|
IOleObject |
|
|
SetMoniker |
Mandatory
if the control is not marked with OLEMISC_CANTLINKINSIDE |
|
GetMoniker |
Mandatory
if the control is not marked with OLEMISC_CANTLINKINSIDE |
|
InitFromData |
Optional |
|
GetClipboardData |
Optional |
|
SetExtent |
Mandatory
only for DVASPECT_CONTENT |
|
GetExtent |
Mandatory
only for DVASPECT_CONTENT |
|
SetColorScheme |
Optional |
|
DoVerb |
See Note 1. |
|
|
|
|
IOleInPlaceObject |
|
|
ContextSensitiveHelp |
Optional |
|
ReactivateAndUndo |
Optional |
|
|
|
|
IOleInPlaceActiveObject |
|
|
ContextSensitiveHelp |
Optional |
|
|
|
|
IViewObject2 |
|
|
Freeze |
Optional |
|
Unfreeze |
Optional |
|
GetColorSet |
Optional |
|
|
|
|
IPersistStream[Init], |
|
|
GetSizeMax |
See Note 2. |
|
1. A control with property pages must support IOleObject::DoVerbs
for the OLEIVERB_PROPERTIES and OLEIVERB_PRIMARY verbs. A control that can be
active must support IOleObject::DoVerbs for the
OLEIVERB_INPLACEACTIVATE verb. A control
that can be UI active must also support IOleObject::DoVerbs for
the OLEIVERB_UIACTIVATE verb. |
|
|
2. If a control supports IPersistStream[Init]
and can return an accurate value, then it should do so. |
|